home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / graphics / mfpic / README < prev   
Text File  |  1994-07-11  |  6KB  |  204 lines
  1. README - for mfpic 0.2.5.1 bug fix, Tue 12 July 1994.
  2. Document's Author:  Geoffrey Tobin.
  3. Based on:  Thomas Leathrum's README for mfpic version 0.1.13.1.
  4.  
  5.  
  6. INTRODUCTION:
  7.  
  8. This distribution contains version 0.2.5.1 of mfpic, a macro package for
  9. including pictures in TeX documents.  The idea behind this package is
  10. to have Metafont do the actual drawing, and store the pictures in a
  11. font that TeX can include in the document.  The macros have been
  12. designed so that the user should never have to learn Metafont to use
  13. these macros -- the TeX macros actually write the Metafont file for
  14. you.
  15.  
  16.  
  17. AVAILABILITY BY FTP:
  18.  
  19. CTAN, the Comprehensive TeX Archive Network, is the first place to
  20. look for TeX related software.  There are three CTAN sites:
  21.  
  22. (USA)    ftp.shsu.edu
  23. (UK)    ftp.tex.ac.uk
  24. (DE)    ftp.dante.de
  25.  
  26. At each of these, the TeX archive is located in the directory named:
  27.  
  28.     tex-archive
  29.  
  30. CTAN also has several mirror archives around the world; see the
  31. CTAN.MIRRORS file for more information.
  32.  
  33. At CTAN, mfpic can be found by typing this at the ftp prompt:
  34.  
  35.     quote site index mfpic
  36.  
  37. mfpic is the subdirectory:
  38.  
  39.     graphics/mfpic
  40.  
  41.  
  42. MANIFEST:
  43.  
  44. bytes     date          file          description
  45.  
  46.  6345  Jul 12 21:35  README           This file
  47.  2165  Jul 12 21:28  CTAN.MIRRORS     List of CTAN archives
  48.  
  49.   512  Nov 09 19:46  mfpic/           Main mfpic distribution
  50.   512  Nov 09 19:42  misc/            Odds and ends
  51.   512  Nov 09 19:41  setup/           ms-dos, unix contributions
  52.  
  53. ./mfpic:
  54. total 80
  55. 10312  Jul 12 21:20  graphbase.mf     MF macros for mfpic
  56.    88  Oct 12 13:20  lamfpic.tex      Redundant LaTeX interface
  57.  1310  Nov 26 1992   lapictures.tex   LaTeX version of pictures.tex
  58. 11511  Oct 13 19:23  mfpic.tex        TeX macros for mfpic
  59. 33459  Oct 26 16:07  mfpicdoc.tex     Documentation for mfpic.tex
  60.  5472  Nov 26 1992   objects.tex      Samples of each drawable object
  61.  1241  Nov 26 1992   pictures.tex     A few more complicated pictures
  62.  
  63. ./misc:
  64. total 60
  65.  4316  Nov 26 1992   MakeTeXPK        Modified MakeTeXPK for Rokicki's dvips
  66. 48447  Jul 07 18:24  mfb.tex          `Metafont for Beginners', version 3 `W3'
  67.   958  Nov 26 1992   rotgroup.tex     Sample rotation macros
  68.  
  69. ./setup:
  70. total 8
  71.   512  Oct 12 13:24  dos
  72.   512  Oct 12 13:24  unix
  73.  
  74. ./setup/dos:
  75. total 12
  76.  6503  Nov 26 1992   mfpic-bat.4dos   4dos batch file to run mfpic
  77.  3449  Nov 26 1992   mfpic-bat.dos    ms-dos ditto
  78.  
  79. ./setup/unix:
  80. total 16
  81.  3081  Nov 26 1992   Makefile         unix Makefile to run mfpic
  82.  2415  Nov 26 1992   README.UNIX
  83.  5043  Sep 07 1992   setups.tex       unix-specific documentation,
  84.                                         containing csh scripts
  85.  
  86.  
  87. HISTORY:
  88.  
  89. The previous net releases of this package were 0.1 in late June (to
  90. comp.text.tex), 0.1.13.1 in early September 1992 (also to c.t.t.),
  91. and 0.2 (to CTAN at ftp.shsu.edu) in late November 1992.
  92.  
  93. Version 0.2.5 is a bug fix release, incorporating the following
  94. changes.  [Acknowledgments are in brackets].
  95.  
  96. Version 0.2.5.1 is a supplement to 0.2.5, to repair a bug in
  97. graphbase.mf.
  98.  
  99.  
  100. CHANGES:
  101.  
  102. To `mfpic.tex' :
  103.  
  104. 1.  If a TFM file is absent, mfpic uses the `dummy' font, and prints
  105.     an appropriate message.  (This change was already added to version
  106.     0.2.  It is noted here for previous users of 0.1.13.1.)
  107.     [Don Hosek, Anil Trivedi.]
  108.  
  109. 2.  LaTeX compatibility:
  110.     Introduction of \mfpicture, to replace \picture.  [K.P. Hart]
  111.     (\mfpic is an alternative name for \mfpicture.)
  112.     If \picture is initially undefined when mfpic is loaded (as in
  113.     plain TeX), then it's let equal to \mfpicture.
  114.     Other changes to make mfpic LaTeX compatible.
  115.  
  116. 3.  Fractional x and y scales are now allowed.
  117.  
  118. 4.  The catcode of `@ is restored correctly.
  119.     [Michael Downes of AMS.]
  120.  
  121. 5.  The sharp character is written as `#' (no longer `\#') in the MF
  122.     file.  Similarly for the percentage character `%'.
  123.     [Donald Arseneau.]
  124.  
  125. 6.  Bad \label options are tested for, and replaced by the default
  126.     text alignment option, which is [bl] (bottom left).
  127.  
  128. 7.  MF char codes out of range (0 - 255) are rejected.
  129.  
  130. 8.  Localised the scope of some declarations.
  131.  
  132. To `mfpicdoc.tex' :
  133.  
  134.     Documentation of the above changes.
  135.  
  136. To `lamfpic.tex' :
  137.  
  138.     lamfpic.tex is redundant, except for use with LaTeX documents that
  139.     were written for mfpic 0.1.13.1 or 0.2.
  140.  
  141. To `graphbase.mf' (version 0.2.5.1) :
  142.  
  143.     unxconv is now a linear transform, not affine.
  144.  
  145.  
  146. EXAMPLE:
  147.  
  148. Here's one of Thomas's personal favorite pieces of mfpic code:
  149.  
  150. \mfpicture[20]{-3}{3}{-3}{3}
  151. \axes
  152. \function{-2,2,0.1,(x**3-x)/3}
  153. \endmfpicture
  154.  
  155. The first line opens up the picture environment and establishes the
  156. coordinate system.  The coorinate scale is 20 points per coordinate
  157. unit (x- and y-axis scales the same in this case), with bounds on both
  158. axes being -3 and 3.  The second line draws the axes.  The third line
  159. plots a smooth Bezier interpolation of the function f(x)=(x^3-x)/3 on
  160. the domain -2<=x<=2, through points with x values 0.1 units apart.
  161. Since the algebraic expression is passed directly to Metafont and
  162. parsed there, the TeX user does not have to worry about computing the
  163. points.  The fourth line closes the picture environment.
  164.  
  165.  
  166. INSTALLATION:
  167.  
  168. Much of the process of setting up your site to use mfpic will be
  169. site-dependent.  The biggest problem, no matter where you are, will be
  170. convincing TeX and the DVI drivers to find the Metafont output files.
  171. This often involves adding the current directory (sometimes also the
  172. parent directory) to the environment variables (or the equivalent
  173. thereof) for the TFM, GF and PK file paths.
  174.  
  175.  
  176. RELATED SOFTWARE:
  177.  
  178. Anthony Starks has written fig2MF, a Fig 2.1 to Metafont converter.
  179. Fig 2.1 is the native graphics language of an X11 GUI drawing program,
  180. xfig.  In fact, fig2MF uses, and its distribution includes, a modified
  181. `graphbase.mf'.  fig2MF is ftp-able from CTAN sites, in the
  182. subdirectory (note the change of case in the name) :
  183.  
  184.     graphics/fig2mf
  185.  
  186. CTAN also has fig2mfpic, which writes mfpic TeX code:
  187.  
  188.     graphics/fig2mfpic
  189.  
  190.  
  191. QUERIES AND BUG REPORTS:
  192.  
  193. If you have problems or find bugs with the mfpic macros,
  194. please e-mail Geoffrey Tobin:
  195.  
  196.     G.Tobin@ee.latrobe.edu.au
  197.  
  198. I probably will not be able to help much with site-dependent setup
  199. stuff (apart from unix and ms-dos), but I should be able to answer
  200. questions about the actual macros.
  201.  
  202. All the Best!
  203. Geoffrey Tobin
  204.